2 VARIABLES AND CONSTANTS 


Programs can process data in a variety of ways. They may, for example, perform 
calculations with numbers, or save and recall strings of text (such as names and phone 
numbers in a data file). 


In all cases, your program must be able to handle values - different types of numbers, 
strings, and so on. 


In OPL, there are two ways of handling values: variables and constants. Constants are 
fixed values (which may be named on the Series 5). Variables are used to store values 
which may change - for example, a variable called X may start with the value 3 but later 
take the value 7. 
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DECLARING VARIABLES 


Most procedures begin by declaring (creating) variables: 
LOCAL x,y,z 


LOCAL is the word telling the Psion to create variables, with the names which follow - here x, y and z 
— separated by commas. 


The statement LOCAL x,y,z defines three variables called x, y and z. The Psion will recognise 
these names whenever you use them in this procedure. (If you used them in another procedure, they 
wouldn’t be recognised; the variables are ‘local’ to the procedure in which they are declared.) 


These variables are initially given the value 0. 


Any variables you wish to use must be declared at the start of a procedure. 


CHOOSING THE VARIABLE 


Before declaring variables, decide what information they are going to contain. There are different types 
of variables for different sorts of values. If you try to give the wrong type of value to a variable, an 
error message will be displayed. 


You specify the type of each variable when you declare it, by adding a symbol at the end of its name. 


Numbers 
e For small whole numbers - for example 6 - use an integer variable. Integer variables have a % 
symbol on the end, for example number%. 


Integer variables can handle numbers only in the range -32768 to +32767. If you try to give an 
integer variable a whole number bigger than this, an error message will be displayed. 


e For larger whole numbers - for example 10000000 - use a Jong integer variable. Long integer 
variables have an & symbol on the end, for example numberé. 


Long integer variables can handle whole numbers in the range -2147483648 to +2147483647. Ifa 
variable may have to handle numbers outside normal integer range, make it a long integer variable. 


e For non-whole numbers - for example 2.5 - use a floating-point variable. Floating-point variables 
have no symbol on the end price, for example. 


If you know that at some stage in your program your variable will have to handle non-whole 
numbers, like 1.2, use a floating-point, not an integer variable. Otherwise you may get 
unpredictable results. (There’s more about this later in this chapter.) 


e For very large whole numbers outside long integer range you should also use floating-point 
variables. 


—> 


It is possible to use the full available range of 64-bit floating-point values, i.e. all real numbers 
with absolute values in the range 2.2250738585072015E-308 to 1.797693 1348623 157E+308 and 
0. Precision remains limited to about 15 significant figures in this range. It is also possible to use 
numbers which have absolute values in the range 5E-324 to 2.2250738585072015E-308 (called 
denormals), however the precision decreases in this range to only | significant figure at the lower 
end. It is possible to enforce the ranges used by the Series 3c and other earlier Psion machines 
(see the Series 3c section below) by using the SETFLAGS command. See the ‘Alphabetic 
Listing’ chapter for details of this. 


Constants for the maximum and minimum values of all variable types are given in Const.oph. See 
the ‘Calling Procedures’ chapter for details on how to use this file and Appendix E for a listing of 
it. 


—_— 


Floating-point variables can handle numbers as big as +9.99999999999e99 and as small as 
+le-99, and 0. Intermediate results in calculations (which are not displayed on the screen) may 
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be exceed this and take any value in the full range of 64-bit floating point numbers (see the 
Series 5 section above) . 


Text 


For text- Are you sure?, 54th, etc. - use a string variable. (Pieces of text are called strings in 
OPL.) String variables have a $ symbol on the end - for example, nameS. 


To declare a string variable, you must follow the $ symbol with the maximum length of string you 
want the variable to handle in brackets. So if you want to store names up to 15 characters long in the 
variable nameS, declare it like this: LOCAL name$ (15) Strings cannot be longer than 255 
characters. 


Array variables 


You may want a group of variables, for example to store lists of values. Instead of having to declare 
separate variables a, b, c, d and e, you can declare array variables a (1) to a(5) in one go like this: 











OCAL a%(5) (array of integer variables) 
,OCAL a(5) (array of floating-point variables) 
,OCAL a$ (5,8) (array of string variables) 

or 
.OCAL a&(5) (array of long integers) 











The number in brackets is the number of elements in the array. So LOCAL a% (5) creates five integer 
variables: a3 (1), a% (2), a%(3),a%(4) and a%(5). 


With strings, the second number in the brackets specifies the maximum length of the strings. All the 
elements in the string array have the same capacity - for example, LOCAL IDS (5,10) allocates 
memory space for five strings, each up to 10 characters in length. 


OPL does not support two-dimensional arrays. 


Initial values 


All numeric variables have zero as their initial value. String variables have a string with no characters 
in it (a null or empty string). Every element in an array variable is also initialised in the appropriate 
way. 


Choosing descriptive names 


To make it easier to write your programs, and understand them when you read through them at a later 
date, give your main variables names which describe the values they hold. For example, in a procedure 
which calculates fuel efficiency, you might use variables named speed and distance. 


All variable names: 











e@ May be entered in any combination of upper and lower case. sPeeD and SpEEd would be 
considered the same name. 





e Must not use any of the names of keywords, as listed in the ‘Alphabetic Listing’ chapter - if you use 
these you will see a ‘Declaration error’ message when you translate your module. 


Other constraints are machine dependent: 
I 
e@ May be up to 32 characters long 


e Must start with either an underscore (_) or an alphabetic character, but after that may use any 
combination of numbers, letters and the underscore character. 


—_— 
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e@ May be up to 8 characters long 


e Must start with an alphabetic character, but after that may use any combination of numbers 
and letters 


The $, & and % symbols are included in the 32 (or 8) characters allowed in variable names, so 
V2345678901234567890123456789012% is too long to be a valid variable name, but 
V234567890123456789012345678901% is acceptable (on the Series 5). 


EXAMPLES 
@ LOCAL clients$(12),z&(3) declares one string variable, clientsS, of capacity 12 
characters, and one long integer array variable containing three elements, z& (1), z& (2) and 
zZ& (3) 








e LOCAL AGE%,B5$ (10) ,i declares one integer variable, AGE%, one string variable, B5$, of 
capacity 10 characters, and one floating-point variable, i 

















@e LOCAL profit93 declares one floating-point variable, profit93 





e LOCAL x,MAN6S (4,7) declares one floating-point variable, x, and one string array variable, 
mané6§, containing four elements, man6$ (1),man6$ (2),mané6$ (3) and man6$ (4), each of 
capacity 7 characters 


For efficiency 


e Integer variables use less memory than long integer variables, and both use less than 
floating-point. 


e Integer variables are processed faster than floating-point. 
GIVING VALUES TO VARIABLES 


Assigning values 
You can assign a value to a variable directly, like this: 


x=5 
y=10 
This procedure adds two numbers together: 
PROC add: 
LOCAL x%,y%,z% 
xS5=569 
ys=203 


PRINT 2% 





GET 


ENDP 





add: is the procedure name. 


The LOCAL statement defines three variables x3, y% and z%, all initially with the value 0. PRINT 
displays the value of z% on the screen. You can display the value of any variable like this. 


PROC and ENDP define the beginning and end of the procedure as you saw in the previous chapter. 


Assigning values to string variables 


String variables can be assigned text values like this: 
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aS=“some text” 


The text you use must be enclosed in double quote characters. 
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Assigning values to an array variable 


If you declare a% (4) , assign values to each of the elements in the array like this: a& (1) =56, 
a% (2) =345 and so on. Similarly for the other variable types: a (1) =.0346, a& (3) =355440, 
a$ (10)=“name”. 


Arithmetic operations 


You can use these operators: 
+ plus 


- minus or make negative 


/ divide 

‘ multiply 

# raise to a power 
% percentage 


Operators have the same precedence as in the Calc application. For example, 3+51 . 3/8 is treated as 
3+ (51.3/8), not (3+51.3) /8. For more information on operators and precedence, see Appendix 
B. 


Values from functions 
There are two kinds of keyword - commands and functions: 


e Acommand is just a straightforward instruction to OPL to do some particular thing. PRINT and 
PAUSE, for example, are commands. 


e A function is just like a command but it also returns a value which you can then use. 


GET is, in fact, a function; it waits for you to press a key on the keyboard, and then returns a value 
which identifies the key which was pressed. (In previous example programs, the value returned by GET 
was ignored, as GET was being used to provide a pause while you read the screen. This is a common 
use of the GET function.) 


The number returned by GET will always be a small whole number, so you might store it away in an 
integer variable, like this: 


a%S=GET 





There is more about the GET function later in this chapter. 


Expressions 


You can assign a value to a variable with an expression - that is, a combination of numbers, variables, 
and functions. For example: 


z=xty/2 gives the z the value of x plus the value of y/2. 
z=x* y+34.78 gives z the value of x times y, plus 34.78. 
z=x+COS (y) gives z the value of x plus the cosine of y. 


COS is another OPL function. Unlike the GET function, COS requires a value or variable to work with. 
As you can see, you put this in brackets, after the function name. Values you give to functions in this 
way are called arguments to the function. There is more information about arguments in the next 
chapter. 


All of the above are operations using the variables x and y - assigning the result to z and not actually 
affecting the value of x or y. 
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The ways you can change the values of variables fall into these groups: 


e Arithmetic operations, such as multiplication or addition - for example z=salestcosts or 
Z=ys* (4-xS) 


e Using one of the OPL functions, for example z=SIN (PI/6) 

or 

e Using certain keywords like INPUT or EDIT which wait for you to type in values from the 
keyboard. 


Self reference 


In expressions, variables can refer to themselves. For example: 
ZS=ZS41 (make the value of z% one greater than its current value) 


x3=x%/4+y (make the value of x% a quarter of its current value, plus the value of y) 


Constants 


In an OPL program, numbers (and strings in quote marks) are sometimes called constants. In practice, 
you will use constants without thinking about them. For example: 


x=0.32 
x3=569 
x&=32768 
x$=“string” 
x (1) =4.87 


OPL can also represent hexadecimal constants. Integers specified in hexadecimal must be preceded by 
a S$ and long integers by a &. For example, $f or &80000000. This is explained under the HEX$ entry 
in the ‘Alphabetic Listing’ chapter. 





Exponential notation may be useful for very large or very small numbers. Use E (capital or lower case) 
to mean “times ten to the power of” - for example, 3.14E7 is 3.14x10’ (31400000), while 1E-9 is 
1x10° (0.000000001). 


I The CONST command may be used to declare constants. This makes it possible to assign a name 
to a constant value so it may be used throughout the module. This has the advantage of making it 
possible to change just one statement rather than many to change the value of a single constant. 
See the ‘Calling Procedures’ chapter for more details of how to do this. 


Problems with integers 


When calculating an expression, OPL uses the simplest arithmetic possible for the numbers involved. If 
all of the numbers are integers, integer arithmetic is used; if one is outside integer range, but within 
long integer range, then long integer arithmetic is used; if any of the numbers are not whole numbers, 
or are outside long integer range, floating-point arithmetic is used. 


This has the benefit of maximising speed, but you must beware of calculations going out of the range 
of the type of arithmetic used. For example, in X=200* 300 both 200 and 300 are integers, so integer 
arithmetic is used for speed (even though X is a floating-point variable). However, the result, 60000, 
cannot be calculated because it is outside integer range (32767 to -32768), so an ‘Overflow’ error is 
produced. 


You can get around this by using the INT function, which turns an integer into a long integer, without 
changing its value. If you rewrite the previous example as X=INT (200) *300, OPL has to use long 
integer arithmetic, and can therefore give the correct result (60000). (If you understand hexadecimal 
numbers, you can instead write one of the numbers as a hexadecimal long integer, e.g. 200 would 
become &C8.) 
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Integer arithmetic uses whole numbers only. For example, if y% is 7 and x% is 4, y3/x% gives 1. 
However, you can use the INTF function to convert an integer or long integer into a floating-point 
number, forcing floating-point arithmetic to be used for example, INTF (y%) /x% gives 1.75. This 
rule applies to each part of an expression - e.g. 1 .0+2/4 works out as 1.0+0 (=1.0), while 
1+2.0/4 works out as 1+0.5 (=1.5). 


If one of the integers in an all-integer calculation is a constant, you can instead write it as a 


floating-point number. 7/4 gives 1, but 7/4.0 gives 1.75. 


Operations on strings 


If aS is “down” and bS$ is “wind”, then the statement cS=a$+bS means c$ becomes 
“downwind”. 


Alternatively, you could give c$ the same value with the statement cS=“down”+”wind”. 


When adding strings together, the result must not be longer than the maximum length you declared e.g. 
if you declared LOCAL a$(5) then aS=“first”+”second” would cause a ‘String is too long’ 
error to be displayed. 


Most operators do not work on strings. To cut up strings, use string functions like MID$, LEFT$ and 
RIGHTS, explained in the ‘Alphabetic Listing’ chapter. You need them to extract even a single 
character you cannot, for example, refer to the fourth character in a$ (7) as a$ (4). 


DISPLAYING VARIABLES 


PRINT is one of the most useful OPL commands. Use it to display any combination of text messages 
and the values of variables. 


Where the cursor goes after a PRINT 
In general, each PRINT statement ends by moving to a new line. For example: 


AS=127 :PRINT “AS is” 
PRINT a% 
would display as 
As is 
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You can stop a PRINT statement from moving to a new line by ending it with a semicolon. For 
example: 


A%=127 :PRINT “AS is”; 
PRINT a% 

would display as 
AS 18127 


If you end a PRINT statement with a comma, it stays on the same line, but displays an extra space. For 
example: 


AS=127 :PRINT “AS is”, 
PRINT a% 
would display as 


AS is 127 
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Displaying a list of things 
You can use commas or semicolons to separate things to be displayed on one line, instead of using one 
PRINT statement for each. They have the same effect as before: 


A%S=127 :PRINT “AS is”,a% 
would display as 

AS is 127 
while 

userS=“Fred” 

PRINT “Hello”,user$;‘!” 
would display as 


Hello Fred! 


Displaying the quote character 


Each string you use with PRINT must start and end with a quote character. Inside the string to display, 
you can represent the quote character itself by entering it twice.So PRINT “Press “” key” 
displays as Press “ key, while PRINT ““’”” displays a single quote character. 


VALUES FROM THE KEYBOARD 


If you want a program to be reusable, it often needs to be able to accept different sets of information 
each time you use it. You can do this with the INPUT command, which takes numbers and text typed in 
at the keyboard and stores them in variables. 


For example, this simple procedure converts from Pounds Sterling to Deutschmarks. It asks you to type 
in two numbers - the number of Pounds Sterling, and the current exchange rate. You can edit as you 
type the numbers - the Delete key, for example, deletes characters, and Esc clears everything you’ve 
typed. Press Enter when you’ve finished each number. The values are assigned to the variables 
pounds and rate, and the result of the conversion is then displayed: 


PROC exch: 


LOCAL pounds, rate 























AT 1,4 
PRINT “How many Pounds Sterling?”, 
INPUT pounds :REM value from keyboard 
PRINT “Exchange rate (DM to £1)?”, 
INPUT rate :REM value from keyboard 
PRINT “=”,pounds*rate, “Deutschmarks” 
GET 

ENDP 





Here PRINT is used to show messages (often called prompts) before the two INPUT commands, to say 
what information needs to be typed in. In both cases the PRINT command ends in a comma, which 
displays a single space, and keeps the cursor position on the same line. Without the commas, the 
numbers you type to the INPUT commands would appear on the line below. 


The value entered to an INPUT command must be of the appropriate kind for the variable which 
INPUT is setting. If you enter the wrong type (for example, if you enter the string three for the 
floating-point variable rate), INPUT will show a ? prompt, and wait for you to enter another value. 


When using INPUT with a numeric variable (integer, long integer or floating-point), you can enter any 
number within the range of that type of variable. Note that if you enter a non-whole number as the 
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value for an integer variable, it will take only the whole number part (so e.g. if you enter 12.75 for an 
integer variable, it will be set to 12). 


Comments 


The REM command lets you add comments to a program to help explain how it works. Begin the 
comment with the word REM (short for ‘remark’). Everything after the REM command is ignored. 


If you put a REM command on the end of a line, the colon you would normally put before it is 
optional. For example, you could use either of these: 


CLS :REM Clears the screen 





or 











CLS REM Clears the screen 





AT command 


This positions the cursor or your message at the co-ordinates you specify. Use the command like this: 
AT column%, row%S 
where column% and row% give the character position to use. 


AT 1,1 positions the cursor to the top left corner. 


Single keypresses 


In addition to using INPUT to ask for values, your program can ask for single keypresses. Use one of 
these functions: 


e GET waits for a keypress and returns the key pressed. 
e KEY returns a key if any was pressed, but doesn’t wait for one. 


Every separate letter, number or symbol has a number which represents it, called a character code. The 
full list of character codes - the character set - for the Series 5 may be found in Appendix D and for the 
Series 3c is included as an appendix to the User Guide. GET and KEY return the character code of the 
key pressed for example, if A were pressed, these functions would return the value 65. KEY returns 0 if 
no key was pressed. 


KEY$ and GET$ work in the same way as KEY and GET, except that they return the key pressed as a 
string, not as a character code: 


e GET$ waits for a keypress and returns the key pressed, as a string. 


e KEY$ returns a key if any was pressed, but doesn’t wait for one. KEY$ returns a null string if no 
key was pressed. 


Unlike INPUT, these functions do not display the key pressed on the screen, and do not wait for you to 


press Enter. 


Example using GET$ 
PROC kchar: 


,OCAL kS (1) 





PRINT “Press a key, A-Z:” 


kS=GETS 





PRINT “You pressed”,kS$ 








PAUSE 60 


ENDP 
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Single keypresses are often useful for making decisions. A program might, for example, offer a set of 
choices which you choose from by typing the word’s first letter, like this: 








Add (A) Erase (E) or Copy (C) ? 





Or it might ask for confirmation of a decision, by displaying a YES or NO? message and waiting 
until Y or N is pressed. 


See the ‘Loops and Branches’ chapter for details of how to identify which key is pressed. 


Modifier keys 


If you need to check for the Shift, Control, Psion (on the Series 3c and Siena only) Fn (Series 5 only) 
keys and/or Caps Lock being used, see the description of the KMOD function, in the ‘Alphabetic 
Listing’ chapter. 


SUMMARY 
Declare variables with one or more LOCAL statements in the line after PROC: 


e Integer variables - for example year’ 

e Floating-point variables - for example price 

e String variables - for example name$ (12) where the maximum length is given in the brackets 
e Long integer variables - for example profits 

Variables will be floating-point unless you add a symbol to the end of the variable name. 


e Array variables - for example prices% (4) or clients$ (5,12) where the first number inside 
the brackets specifies the number of elements, and the second number in the brackets, in the case of 
string arrays, specifies the maximum length. 


All identifiers may have a maximum length of 32 characters (8 on the Series 3c). 
Assign values to variables: 
e Expressions - for example x=5.5/y ,profit=x-y 
e INPUT command - forexample INPUT a$ 
e ‘Add’ strings - for example aS=“MR”+names$ 
REM allows you to add comments to a program. 
AT positions the cursor. 
GET and KEY return the key pressed as a character code. 
GET$ and KEY$ return the key pressed as a single-character string. 
GET and GET$ wait until a key is pressed, KEY and KEY$ do not. 
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